Cette page liste les rapports que les propriétaires de chaînes peuvent récupérer à l'aide de l'API YouTube Reporting. Le id de chaque rapport, tel que renvoyé par la méthode reportTypes.list de l'API, est fourni dans la description du rapport.
Signalements de vidéos
Les rapports sur les vidéos fournissent des statistiques sur l'activité des utilisateurs concernant les vidéos d'une chaîne. Par exemple, ces rapports indiquent le nombre de fois où vos vidéos ont été regardées.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur l'activité des utilisateurs concernant la chaîne et ses vidéos. La valeur id de ce rapport est channel_basic_a2.
La valeur id de cette version du rapport est channel_basic_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs pour les États américains et le district de Columbia. La valeur id de ce rapport est channel_province_a2.
La valeur id de cette version du rapport est channel_province_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application sur laquelle les vidéos ont été lues. La valeur id de ce rapport est channel_playback_location_a2.
La valeur id de cette version du rapport est channel_playback_location_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_detail |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé au contenu vidéo de la chaîne.
Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée. La valeur id de ce rapport est channel_traffic_source_a2.
La valeur id de cette version du rapport est channel_traffic_source_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage des vidéos en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows. La valeur id de ce rapport est channel_device_os_a2.
La valeur id de cette version du rapport est channel_device_os_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Données démographiques des spectateurs
Ce rapport regroupe les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs.
La valeur id de ce rapport est channel_demographics_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, age_group, gender |
| Métriques : | views_percentage |
Partage de contenu par plate-forme
Ce rapport fournit des statistiques sur la fréquence à laquelle les vidéos de la chaîne ont été partagées sur différentes plates-formes de réseaux sociaux.
La valeur id de ce rapport est channel_sharing_service_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métriques : | actions |
Annotations
Ce rapport fournit des statistiques sur les annotations qui s'affichent pendant les vidéos d'une chaîne.
Les données du rapport mesurent les performances des annotations individuelles pour chaque vidéo. En revanche, le rapport sur l'activité des utilisateurs regroupe les statistiques de toutes les annotations d'une vidéo.
La valeur id de ce rapport est channel_annotations_a1.
Cartes
Ce rapport fournit des statistiques sur les impressions et les clics pour les fiches qui s'affichent pendant les vidéos d'une chaîne.
Les données du rapport mesurent les performances de chaque fiche. En revanche, le rapport sur l'activité des utilisateurs regroupe les statistiques de toutes les fiches d'une vidéo.
La valeur id de ce rapport est channel_cards_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
| Métriques : | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Écrans de fin
Ce rapport fournit des statistiques sur les impressions et les clics pour les écrans de fin qui s'affichent à la fin de la lecture d'une vidéo.
Il contient des statistiques sur les vidéos d'une chaîne.
La valeur id de ce rapport est channel_end_screens_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, end_screen_element_type, end_screen_element_id |
| Métriques : | end_screen_element_clicks, end_screen_element_impressions, end_screen_element_click_rate |
Sous-titres
Ce rapport fournit des statistiques sur la langue des sous-titres utilisée pendant la durée la plus longue lors des visionnages de vidéos. Les vues pour lesquelles les sous-titres sont généralement désactivés sont exclues. La valeur id de ce rapport est channel_subtitles_a2.
La valeur id de cette version du rapport est channel_subtitles_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, subtitle_language, subtitle_language_autotranslated |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Combinées
Ce rapport fournit des statistiques vidéo détaillées en combinant les dimensions utilisées dans les rapports Emplacement de la lecture, Source de trafic et Appareil/OS. La valeur id de ce rapport est channel_combined_a2.
La valeur id de cette version du rapport est channel_combined_a2. Elle présente les différences suivantes par rapport à la version a1:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, traffic_source_type, device_type, operating_system |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Rapports sur les playlists
Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos dans le cadre d'une playlist.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists d'une chaîne.
La valeur id de ce rapport est playlist_basic_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs concernant leurs interactions avec les playlists d'une chaîne pour les États américains et le district de Columbia.
Cela signifie que le rapport est filtré pour n'inclure que les données si la valeur de la dimension country_code est US. La valeur id de ce rapport est playlist_province_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application sur laquelle les playlists ont été lues. La valeur id de ce rapport est playlist_playback_location_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_detail |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé aux vidéos d'une playlist d'une chaîne.
Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée. La valeur id de ce rapport est playlist_traffic_source_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage des playlists en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows. La valeur id de ce rapport est playlist_device_os_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Combinées
Ce rapport fournit des statistiques détaillées sur les playlists en combinant les dimensions utilisées dans les rapports Emplacement de lecture, Source de trafic et Appareil/OS. La valeur id de ce rapport est playlist_combined_a1.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, traffic_source_type, device_type, operating_system |
| Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |